home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / glio_group.z / glio_group
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  80 lines
  1. GLIO_GROUP(3F)                                        Last changed: 1-22-99
  2.  
  3.  
  4. NNAAMMEE
  5.      gglliioo__ggrroouupp__mmppii, gglliioo__ggrroouupp__sshhmmeemm - Defines a group of processes to be
  6.      associated with a global file.
  7.  
  8. SSYYNNOOPPSSIISS
  9.      C or C++:
  10.  
  11.           ##iinncclluuddee <<ffffiioo..hh>>
  12.           ##iinncclluuddee <<mmppii..hh>>
  13.           vvooiidd gglliioo__ggrroouupp__mmppii((MMPPII__CCoommmm _c_o_m_m))
  14.           ##iinncclluuddee <<mmpppp//sshhmmeemm..hh>>
  15.           vvooiidd gglliioo__ggrroouupp__sshhmmeemm((iinntt _h_a_n_d_l_e));;
  16.  
  17.      Fortran:
  18.  
  19.           iinncclluuddee ""mmppiiff..hh""
  20.           IINNTTEEGGEERR _c_o_m_m
  21.           CCAALLLL GGLLIIOO__GGRROOUUPP__MMPPII((_c_o_m_m))
  22.           iinncclluuddee ""mmpppp//sshhmmeemm..ffhh""
  23.           IINNTTEEGGEERR _h_a_n_d_l_e
  24.           CCAALLLL GGLLIIOO__GGRROOUUPP__SSHHMMEEMM((_h_a_n_d_l_e));;
  25.  
  26. IIMMPPLLEEMMEENNTTAATTIIOONN
  27.      UNICOS/mk and IRIX systems
  28.  
  29. DDEESSCCRRIIPPTTIIOONN
  30.      These subroutines identify the group of processes which will share
  31.      access to any FFIO files opened with the gglloobbaall FFIO layer.  These
  32.      files, termed _g_l_o_b_a_l _f_i_l_e_s, must be opened and closed collectively by
  33.      all processes that share access to them.
  34.  
  35.      The following is a list of valid arguments for these routines:
  36.  
  37.      _c_o_m_m      An MPI communicator. The group of processes associated with
  38.                this communicator will access the global file.  This process
  39.                group must be executing within a single host machine.
  40.  
  41.      _h_a_n_d_l_e    A SHMEM process group handle returned from the
  42.                sshhmmeemm__ggrroouupp__ccrreeaattee__ssttrriiddeedd(()) function.
  43.  
  44.      The gglliioo__ggrroouupp__mmppii and gglliioo__ggrroouupp__sshhmmeemm functions are collective
  45.      across the set of processes identified by _c_o_m_m or _h_a_n_d_l_e.
  46.  
  47.      If gglliioo__ggrroouupp__mmppii or gglliioo__ggrroouupp__sshhmmeemm are not called prior to an open
  48.      of a gglloobbaall file, all MPI or SHMEM processes in the application must
  49.      collectively open and close the file.
  50.  
  51. EEXXAAMMPPLLEESS
  52.      The following Fortran program opens global file gglloobbffiillee for access
  53.      from SHMEM processes (PEs) 0 and 1.  PEs 2 and higher will not access
  54.      the file.
  55.  
  56.           program global_subset
  57.           include "mpp/shmem.fh"
  58.           integer racom, handle
  59.           common /racom/ racom(SHMEM_GROUP_COM_SIZE)
  60.  
  61.           call start_pes(0)
  62.           racom = 0
  63.  
  64.      c    Define a SHMEM group and then open globfile across this group
  65.  
  66.           if (my_pe().le.1) then
  67.             call assign("assign -F global u:20",ier)
  68.             handle = shmem_group_create_strided(0, 1, 2, racom, shmem_null)
  69.             call glio_group_shmem(handle)
  70.             open (20,file="globfile",access="direct",recl=64)
  71.           endif
  72.  
  73.           end
  74.  
  75. SSEEEE AALLSSOO
  76.      sshhmmeemm__ggrroouupp__ccrreeaattee__ssttrriiddeedd(3)
  77.  
  78.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed
  79.      version of this man page.
  80.